home *** CD-ROM | disk | FTP | other *** search
/ Precision Software Appli…tions Silver Collection 4 / Precision Software Applications Silver Collection Volume 4 (1993).iso / new / s3frgn21.arj / FRGN21.DOC < prev   
Text File  |  1993-08-14  |  8KB  |  192 lines
  1. Program:      S3 Foreign Mailing Preprocessor (SFP)
  2. Version:      2.1
  3. Date:         08/14/93
  4. Author:       George Spafford
  5.  
  6. Purpose:
  7.  
  8. To identify country names in either delimitted, or fixed-length ASCII
  9. data files and then add the ISAL code and/or geographic location.
  10.  
  11. Why?
  12.  
  13. Every day, I deal with mailing lists from many customers that have a 
  14. mixture of U.S., Canadian and foreign addresses.  In order for our mail
  15. line to properly process the mailing lists, they process the domestic
  16. names and then they pull out and process the Canadian names.  We use an
  17. excellent mailing list program called Arclist by Group One software.  
  18.  
  19. Arclist is really an excellent database program aimed at processing
  20. mailing lists according to the latest requirements.  For domestic mail, 
  21. it does an excellent job and I recommend it.  However, for foreign mail,
  22. there are are times when you need to print the countries out in an index
  23. order other than just by country name. 
  24.  
  25. The foreign mail preprocessor, as I call it, takes ASCII data files and
  26. adds an ISAL (International Surface Air Lift) code to the record if there
  27. is one.  It also adds a geographical location name to each record.  Now,
  28. you can print out your mailing list on a sort order of ISAL-COUNTRY-CITY or
  29. GEOGRAPHICAL-COUNTRY-CITY.  This helps our mail line tremendously and it
  30. may help yours.
  31.  
  32. This program will probably only be of use to you if you do a lot of importing
  33. of data and then sorting it yourself.  Of course, if you can think of other
  34. uses, then have at it!
  35.  
  36. How?
  37.  
  38. Okay, besides the normal fields that have importance in mailing, such as the
  39. Name, Company Name, Address 1, Address 2, City, State and Zip, you must also
  40. add Country Name, ISAL and Location. 
  41.  
  42. The country name you must key in. Guidelines for country names include:
  43.  
  44.         -  Upper Case
  45.         -  By itself
  46.         -  No abbreviations
  47.         -  Avoid punctuation
  48.         
  49. These guidelines, and others, can be found in the U.S. Post Office's IMM
  50. (International Mail Manual) and the World Post Office's ISAL guidebook.
  51.  
  52. You must have the country names in a consistent field location throughout
  53. the entire data file.  If you do not, then this program will not work for you.
  54.  
  55. COUNTRY.LST
  56.  
  57. The FOREIGN.EXE file, when it is first started, loads a data file called
  58. COUNTRY.LST that contains country names, ISAL codes and Location.  If you
  59. need to add to, or change this file, you can.  However, you can not have
  60. more than 400 entries.  Samples:
  61.  
  62. COUNTRY|GROUP|LOCATION  'do not delete this record!!!!!!!!
  63. Afghanistan||AS
  64. Albania|1|EU
  65. Algeria|4|AF
  66. Andorra||EU
  67. Angola|4|AF
  68. Antigua and Barbuda||NA
  69. Argentina|2|SA
  70. Aruba|2|NA
  71.  
  72. This file must be in the same directory as the FOREIGN.EXE file.  Do NOT
  73. delete the first record!!!  If you need to edit this file, use EDIT, QEdit,
  74. EDLIN or another ASCII editor.  Do not use a word processor that adds
  75. control codes.  If the entry does not have an ISAL code, such as Andorra,
  76. do not put one in.  The program will put a 999 in automatically when it runs.
  77. Always put in the geographical location.  If there is not one, the program
  78. will assign a location of XXX.  The program will also assign these codes if
  79. there are abbreviations or mis-spellings in the country name and it can not
  80. identify it.
  81.  
  82. COUNTRY.LST file specification:
  83.  
  84.         Country Name            30 bytes
  85.         |                       01
  86.         ISAL Code               03
  87.         |                       01
  88.         Location                03
  89.         
  90.  
  91. Processing lists:
  92.  
  93. An important note!  FRGN88.EXE is designed for 8088 and 80286 systems.  The
  94. FRGN386.EXE program is optimized for 80386 and above processors.  Use the
  95. .EXE that matches your hardware for the best performance.
  96.  
  97. Run the program and then answer its questions about the input and output file
  98. names.  Note, these file names can not be the same.  After you have entered the
  99. file names, tell the program whether the data file is delimited or fixed length.
  100.  
  101. If it is fixed length, tell it the starting byte of the country field and the
  102. length of the field. (In English, look at the data file and count the number of
  103. characters from the left edge to where the country names start - this is the
  104. starting byte and then count how many characters long the field is - this is
  105. the length).
  106.  
  107. If it is delimitted, tell the program the field delimitter used and the
  108. number of the field, counting from the left, that holds the country name.
  109. When the program asks about the use of literals, it is asking if you want to
  110. have the location and country code encapsulated by quotation marks.
  111.  
  112. The program will then process your file.  If you have a fixed length record
  113. format, then the program will add 6 bytes to your overall record length in
  114. the format of CCCLLL.  Where CCC is a 3 digit desciptor of the ISAL code or a
  115. 999 if an ISAL code does not exist.  LLL is the geographic location, or an
  116. XXX if a location is not identified.
  117.  
  118. GEOGRAPHIC LOCATIONS TABLE:
  119.  
  120. In the COUNTRY.LST file, you can set up the locations however you wish.  I used
  121. the following:
  122.  
  123.         North America           NA
  124.         South America           SA
  125.         Europe                  EU
  126.         Asia                    AS
  127.         Pacific and Australia   PA
  128.         Africa                  AF
  129.         Atlantic Ocean          AO
  130.         
  131. I just used an atlas to group the countries accordingly.  If you need to be
  132. more specific, then just change the COUNTRY.LST file.
  133.  
  134. HISTORY:
  135.  
  136.         v2.1    08/14/93
  137.                 The program can now process delimitted records that are mixture
  138.                 of fields encapsulated by quotes and fields that are not.  For
  139.                 example:
  140.                         11111,"Mr. John Smith, Jr.",1,1,1,22,"3000 West St"
  141.  
  142.                 Version 1.0 required that all fields either be encapsulated by
  143.                 quotes or no quotes at all.
  144.                 FRGN386.EXE is optimized for 80386 and above processors.
  145.                 FRGN88.EXE is for 8088 and 80286 systems.
  146.  
  147.         v1.0    11/12/92
  148.  
  149.                 Initial release.
  150.  
  151.         ============================
  152.         Please Register This Program
  153.         ============================
  154.  
  155.  
  156. The S3 Foreign Preprocessor (SFP) is distributed as SHAREWARE.
  157. It is not Public Domain.  If you find that this program aids you in your
  158. work, it must be registered within 30 days of your first usage of it.
  159. Continued use of the program without paying for it is a violation of the site
  160. license and constitutes software piracy.
  161. This product is priced at $10 US per concurrently used copy.
  162.  
  163. Registration of this product will allow me to continue developing
  164. specialized software for you, the consumer, at shareware prices.
  165. Payments (please do not send cash) can be sent to:
  166.  
  167.           George Spafford
  168.           3003 Lakeshore Drive, #216
  169.           St. Joseph, MI 49085
  170.           USA
  171.     
  172.  
  173. I can also be reached on the EXEC-PC BBS and the Channel One BBS.
  174.  
  175. SHAREWARE DISTRIBUTORS:
  176.  
  177. You may distribute this program as long as it is made clear that you are
  178. only a distributor and that the program is not registered until they make
  179. payment to me.  Please do not charge more than $5 per disk to distribute 
  180. SFP to your customers.
  181.  
  182. ::::: Legal :::::
  183.      
  184. SFP IS DISTRIBUTED AS IS.  THE AUTHOR (GEORGE SPAFFORD) MAKES
  185. NO WARRANTIES OF APPROPRIATENESS, MERCHANTABILITY OR FITNESS FOR A
  186. PARTICULAR PURPOSE.  THE AUTHOR ASSUMES NO LIABILITY FOR ANY DAMAGES
  187. (INCLUDING LOST PROFITS, WAGES OR ANY OTHER CONSEQUENTIAL OR INCIDENTAL
  188. DAMAGES) ARISING OUT OF THE MISUSE OR INABILITY TO USE THIS PRODUCT.
  189.  
  190.  
  191.  
  192.